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' STRUCDEF == pecan ign FILE FOR DATA STRUCTURE DEFINITION 
; AND ACCESS MACROS USED IN THE VAX DEBUGGER 


i mae Se ee Deane mrs se weenmrewenmrevternetzerenrneaawzran wren aanwae een we we @ @ @ = & & @ wo = &@ we woo ome ana Se 
: Version: *v04-000' 
i eeeereeerereerrerereererererereretereteerererereneeerererereerereeeeeeeetete 


ie COPYRIGHT | ep 1978, 1980, 1982, 1984 BY 
ie DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ie ALL RIGHTS RESERVED. 


te THIS he 4 FURNISHED eee A LICENSE AND MAY BE USED AND sorte 
'* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH iat SE AND WITH THE 
:* INCLUSION OF OTHE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
ie COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
:* OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 


® 
& 
® 
® 
® 
® 
he 
® 
® 
cm 
ie TRANSFERRED. “ 
x 
® 
& 
® 
® 
® 
ie 
* 
aw 
® 


:* THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
:: peeokat ihn NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


!® DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
:* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


VS eee e RARER EAA AAAEARAAAEARARAREAAAAAEAATAAAAAAAAAAAAAEEHAAAAE EKER Eee eee 


WRITTEN BY 
Bert Beander August, 1981. 


MODULE FUNCTION: 
This REQUIRE file contains all macros used in —, and accessing 
data structures (BLISS BLOCKs) in the VAX Debugger. These symbolic 
names should always be used in BLISS Field-References. 


acca 
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DATA STRUCTURE DEFINITION AND ACCESS 


The following macros must be used in defining field names for all data 
structures in the pebugger . These macros ee the position, size, and 
sign-extension values when used in FIELD declarations for BLOCK and 
BLOCKVECTOR data structures. The various generic forms (as specified by 
the letters in the names) are as follows: 


A Materialized address 

L Longword 

W Zero-extended word 

8 Zero-extended she 

Vv Zero-extended bit fieid 
Sw Sign-extended word 

$B Sign-extended pyte 

SV Sign-extended bit field 


The “‘A’’ form should be used whenever the field being defined is such 
that only the address of the field may be materialized in a structure 
reference; that is, fetch and store operations on the field are not 
valid. An example of such a field is an ASCII string. 


parameter is the bit position within the om ot (or byte) and the 
second is the field size in bits. The second parameter is optignat: 

if omitted, it defaults to 1. Thus V_(5) means bit 5 while V_(5,3) 
means the $-bit field starting at bit 5 and onerne at bit 7. Bit 
robedee ig are counted from the low-order (least significant) end of the 
ongword, starting at zero. 


The following data structure picture shows the locations of the various 
fields that can be specified. Note how the bit positions are numbered 
along the top of the illustration. | 


3322 $ 2 ¢ 2 § $ 2 3 Bees heRESR 
10987654 1098765432109876543210 
quensececessnces eee ene n ene n eee - eee ee oe + 
0 ame eeoeoeoeoeoeo FS See 2 S222 22222222222 lL. : 
, : Wis : + 
' B1 ' B0_ ' 
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' 
' 
' 
' 
! 
' 
' 
1 
' 
! 
t 
' 
' 
' 
' 
' 
' 
! 
1 
! 
‘ 
: Each of the ‘'V"’ and ‘‘Sv'’ forms take one or two parameters. The first 
' 
i 
! 
' 
' 
‘ 
! 
1 
‘ 
' 
+ 
' 
' 
' 
1 
' 
‘ 
' 
' 
‘ 
' 
' 
' 
‘ 
' 


- O;, Of, ! Address of a longword 


0 
m = g. 0, 8 z, ! Address of byte 0 
Al = 8 OQ, i, ! Address of byte 1 
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A 16, 
se 
.. = 0: 
We = ° 
8. = , 
wO_ = 0, 
wi? = 16, 
B0_ = QO, 
B1_ = 8, 
Be - = 16, 
B3_ = 24, 


' 
' END OF STRUCDEF.REQ 


oooo oO coo OO 


Pererere seve vevere vere 


Vi(P,S) = P, ZIF ZNULL(S) ZTHEN 


F 
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Address of byte 
Address of byte 


' Longword 

! Word, zero-extended 
! Byte, zero-extended 
! word 0 zero-extended 
! Word 1 zero-extended 
' Byte 0 zero-extended 
' Byte 1 zero-extended 
! Byte 2 zero-extended 
! Byte 5 zero-extended 


1 ZELSE S ZF, 0 %, 


vi ee S$) =P ZIF ZNULL(S) XTHEN ! ZELSE S$ ZF I, 4 iz, 
P.S) = (P48), IF ENULL(S) RTHEN 1 XELSE S ZFI. O 
(P55) = (P4165, ZIF ZNULL(S) ZTHEN 1 ZELSE S 2FI. 0 2, 
(p°3) = (P+26), ZIF ENULL (S) ZTHEN 1 TELSE S$ ZF1, 0%, 
Sw_ = 0, 16, 1%, ! Word, sign-extended 
$B_ sw 8 3 Se i Byte, sign-extended 
Swo_ = 0, 16, 1%, ! word 0 sign-extended 
Swi_ = 16, 16, 1%, ! Word 1 sign-extended 
$B0_ °e ® 8. 1 F. ! Byte 0 sign-extended 
$B1_ °* & 8. 1 Be ! Byte 1 sign-extended 
SB2_ = 16, 8 1%, ! Byte ¢ sign-extended 
$B3_ Soy & FT Ee ! Byte 3 sign-extended 
SV_(P,S)= P, ZIF ZNULL(S) XZTHEN 1 ZELSE S &FI, 1 &, 
SVO_(P,S) = P, TIF pent ts ZTHEN 1 ZELSE S 2FI, 1 2%, 
Sv1_ (P. S) = (P+B8), IF ZNULL(S) ZTHEN 1 ZELSE S 2FI, 1 &, 
Sv2-(P.5) = (P+165, IF XNU NULL (3) XTHEN 1 XELSE S$ 2FI, 12%. | 
SV < ™ S) = (P#24), ZIF ZNULL(S) ZTHEN 1 ZELSE S 2F1, 1 &:; 


! Unsigned bit field 
! Bits in BO_ 
8 


! Signed bit field 


! Bits in BO_ 
! Bits in B1_ 


Bits in B2_ 
! Bits in B3_ 
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